home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 22 / Amiga Format AFCD22 (Jan 1998, Issue 106).iso / -seriously_amiga- / shareware / archivers / detar / detar.doc < prev    next >
Text File  |  1997-11-17  |  8KB  |  241 lines
  1.  
  2.  
  3.                                 DeTar V1.3
  4.  
  5.                               - PUBLIC DOMAIN -
  6.  
  7.           ported and re-written in 1994-97 by Andreas R. Kleinert.
  8.           based on code for MS-DOS written in 1988 by Steve R. Sampson
  9.  
  10.           This program was written under OS V3.1 and is therefore
  11.           fully compatible. It needs OS V1.2+.
  12.  
  13.           Release Date : 27.10.1997
  14.  
  15.  
  16.     Copyright :
  17.     ===========
  18.     The program DeTar and its documentation files are placed in the
  19.     PUBLIC DOMAIN.
  20.  
  21.  
  22.     Disclaimer :
  23.     ============
  24.     The author takes no responsibility for any results of the use of this
  25.     program.
  26.     This software is provided "AS IS" and there is no warranty of any kind,
  27.     so that you use this software at your own risk.
  28.  
  29.  
  30.     Distribution :
  31.     ==============
  32.     The program Detar is freely distributable (PUBLIC DOMAIN).
  33.     You may copy it, if all of its parts are included in the distribution.
  34.  
  35.     This program may be put on public domain disks or included in public
  36.     domain disk libraries.
  37.     Special permission hereby goes to Fred Fish's AmigaLib-Disks and
  38.     the german series (in alphabetical order) :
  39.     AmigaSzene, BerndsPD, FRANZ, GPD, TAIFUN and TIME.
  40.  
  41.     This program may also be distributed via electronic mail and may be
  42.     put into mailboxes as long as the redistribution conditions are
  43.     respected in all points. Special permission hereby goes to Aminet.
  44.  
  45.     By using or distributing this program you automatically agree to
  46.     all of the above conditions and terms.
  47.  
  48.  
  49.     Function/Usage :
  50.     ================
  51.     "DeTar" extracts Unix Tar-Archives and may - not very well -
  52.     also list their contents.
  53.  
  54.     Extracting :       DeTar [Archive-Name]
  55.     Listing    :       DeTar d [Archive-Name]
  56.  
  57.     Often Tar-Files have been "zipped" with GZip, after that changing
  58.     their extension to ".tgz".
  59.     Just extract the original Archive with "GZip" and then use "DeTar"
  60.     on them.
  61.  
  62.  
  63.     Additional Information / Credits :
  64.     ==================================
  65.  
  66.     [ History ]
  67.  
  68.     Did you ever tried to extract a simple Unix TAR-Archive ?
  69.  
  70.     Some time ago I bough a "Source-Code" CD-ROM (Walnut Creek), which
  71.     mainly contained ".zip", ".tgz" and ".tar" Files, but nearly no
  72.     unarchived Source-Codes.
  73.     It was quite easy to find programs to extract the ".zip" (UnZip)
  74.     and ".tgz" (GZip) Archives, but what about the ".tar" Archives ?
  75.     Additionally, the ".tgz" Files also contain Tar-Archives !
  76.  
  77.     Due to the fact, that I couldn't find any Tar-Archiver anywhere
  78.     (Fish-Disks, SaarAG-Disks, ...), I decided to port one from
  79.     Unix, MS-DOS, or whatever.
  80.     So I tried to find a Tar-Archive-Source for any of these Systems
  81.     on the CD-ROM.
  82.     Most of the Tar-Archivers there were either only MS-DOS executables
  83.     without any Source-Code, or they had been archived with Tar themselves !
  84.     After searching some time, I found the "PDTAR" source code for Unix,
  85.     but I was very hard to port it, because of the missing User/Group
  86.     functions under AmigaDOS and other Unix standard functions.
  87.     So I took the Source of "detar" for MS-DOS, which is public domain
  88.     and also based on the original "GNU tar".
  89.     I removed the MS-DOS specific functions and created an Amiga Version,
  90.     which is still thought to do only the _main_ thing :
  91.     extracting tar-files to disk-based mediums !
  92.     The original SourceCode is as well included as the Amiga-Source !
  93.  
  94.     "detar" for MS-DOS has been written in 1988 by Steve R. Sampson
  95.     and bases on the originally public domain TAR program by John Gilmore.
  96.     The original documentation of "detar" has been appended to this
  97.     doc-file.
  98.  
  99.  
  100.     Correspondence :
  101.     ================
  102.     Send bug-reports, money or whatever to :
  103.  
  104.        EMail: Andreas_Kleinert@t-online.de
  105.        Fido:  2:2457/350.18
  106.  
  107.  
  108.     History :
  109.     =========
  110.  
  111.      V1.3 (27.10.1997):
  112.      ------
  113.       - recompiled with SAS/C 6.58
  114.  
  115.      V1.2 (28.3.1995):
  116.      -----------------
  117.       - replaced time conversion functions with SAS/C pendants
  118.       - using GlobalSymbolTable now, thus some self-made definitons
  119.         could be removed
  120.       - clearified code by replacing some ints with longs
  121.       - re-packed MS-DOS stuff with LHA
  122.       - added 68030 version
  123.       - and more
  124.  
  125.      V1.1 (24.4.1994):
  126.      -----------------
  127.       - first version. Public Domain.
  128.  
  129.  
  130.     Copyrights :
  131.     ============
  132.     Some of the mentioned names or products above may be copyrighted by
  133.     companies or trademarks of companies.
  134.  
  135.  
  136.  ***************************************************************************
  137.  
  138.     Original Documentation follows
  139.  
  140.  ***************************************************************************
  141.  
  142.                               Detar Documentation
  143.  
  144.                                 23 January 1988
  145.  
  146.    The Unix(tm) Forum has decided to archive its uploads in the compressed
  147. TAR format.  The 'detar' program is meant to provide you with a method of
  148. bursting the files on an MS-DOS(tm) computer.  Additionally the source code
  149. in 'C' is included so others can use it as a base for porting to other
  150. computers.  As a disclaimer: not a lot of planning went into the program.
  151. I basically rounded up some code laying around and threw it together.
  152.  
  153.    In order to make the program useful to MS-DOS computers some features
  154. of TAR format had to be worked around.  For instance: filenames.  The solution
  155. was simple, reduce to 3 characters after the first dot '.'.  Reduce to eight
  156. characters before the dot.  Multiple dots are changed to dash '-' after the
  157. first dot is found.  (Run this program on smail.tar for a good example).
  158.  
  159. The directory 'd' option shows all the filenames in their original state.
  160.  
  161.    The 'detar' program has exactly two options.  One is to perform a direct-
  162. ory, and the second is to extract files.  There is no TAR create routines.
  163. The directory output can be redirected to a file or a printer.  The best
  164. method of using the extraction option is as follows:
  165.  
  166.         1.      Put the detar.exe file in the \bin directory.  Set your path
  167.                 command to search the \bin.
  168.  
  169.         2.      Create a working directory, such as:  'MD TMP'.
  170.  
  171.         3.      Change to the temporary directory:  'CD TMP'.
  172.  
  173.         4.      Execute detar:  'detar ../smail.tar'
  174.  
  175.                 This will begin building files in the TMP directory based
  176.                 on the naming algorithm above.  This is the simplest method
  177.                 and you will determine your best procedure after working with
  178.                 the program for awhile.
  179.  
  180.    A sample of the output received when executing the 'directory' option:
  181.  
  182.         C>detar d ../smail
  183.  
  184.         -rw-r--r-- 102/10  1006 Aug 27 21:42 1987 src/Makefile
  185.         -rw-r--r-- 102/10  9875 Aug 27 21:42 1987 src/alias.c
  186.         -rw-r--r-- 102/10  9983 Aug 27 21:43 1987 src/defs.h
  187.         -rw-r--r-- 102/10 10007 Aug 28 14:39 1987 src/defs.h.kk
  188.         -rw-r--r-- 102/10 12008 Aug 27 21:42 1987 src/deliver.c
  189.         -rw-r--r-- 102/10  2533 Aug 27 21:42 1987 src/getopt.c
  190.         -rw-r--r-- 102/10  2218 Aug 27 21:42 1987 src/getpath.c
  191.  
  192.         ...
  193.  
  194. The first column is the protection bits.  It is Unix specific.  As is
  195. the next column which is the user and group number of the person who made
  196. the archive.  Absolutely no use at all in MSDOS.  The third column is the file
  197. size in bytes.  The fourth column is the date, and the fifth is the complete
  198. filename.
  199.  
  200.    If you make a mistake on the detar command line, three error messages are
  201. output:
  202.  
  203.         C>detar g ..\smail
  204.  
  205. 1.      Usage: detar [d] filename[.tar]
  206.         Where d means directory only
  207.  
  208.         C>detar ..\smale
  209.  
  210. 2.      Tar File '..\SMALE.TAR' Not Found
  211.  
  212.         C>detar ..\detar.c
  213.  
  214. 3.      File '..\DETAR.C' not a TAR archive
  215.  
  216. The brackets ('[', ']') shown on the "Usage" line mean that the information
  217. contained within them are optional.
  218.  
  219.    A sample output from the extraction option follows:
  220.  
  221.         C>detar smail
  222.         Extracting: Makefile
  223.         Extracting: alias.c
  224.         Extracting: defs.h
  225.         Extracting: defs.h-k
  226.         Extracting: deliver.c
  227.         Extracting: getopt.c
  228.         Extracting: getpath.c
  229.  
  230.         ...
  231.  
  232. ----------------
  233. 23 Jan 88 - First bugs fixed.  Insufficient testing.  Names without a pathname
  234.             were munged.
  235. ----------------
  236.  
  237. If you have any further questions or comments (especially improvements)
  238. feel free to contact me.
  239.  
  240. Steve R. Sampson, Compuserve(tm): 75136,626, Usenet: sampson@killer.UUCP
  241.